REST PUT — полная замена ресурса по URI (идемпотентен).

Использование

  • PUT /users/123 с полным представлением ресурса.

Правила

  • Если ресурса нет, некоторые API создают его (upsert); уточнять в контракте.

  • Ответы: 200 OK / 204 No Content при обновлении, 201 Created при создании.

  • Требуется полное тело ресурса; частичные изменения — REST PATCH.

Пример:

PUT /users/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"id":123,"email":"new@example.com","active":true}

HTTP/1.1 200 OK
Content-Type: application/json

{"id":123,"email":"new@example.com","active":true}

Полностью заменяем ресурс указанным представлением.

Последнее обновление